v4.1.1

2025-01-24

Kotlin 2.1.0 (#​6291)

The artifacts are now compiled with Kotlin 2.1.0. This change should be transparent for JVM and Android users thanks to languageVersion but requires klib consumers (native + JS) to update their KGP version to 2.1.0.

Rover LSP support in the IntelliJ plugin (#​6274)

The IntelliJ plugin now has a dedicated mode for backend developers that uses Rover LSP (Language Server Protocol) to parse federation and connectors directives. This mode is only available when using IntelliJ Ultimate and other IDEs with LSP support. It is recommended for subgraphs authors.

Gradle isolated projects support (#​6351)

This release supports Gradle isolated projects for shorter configuration times.

Contributors 💙💙

Many thanks to @​jvanderwee, @​varahash, @​whyoleg, @​StylianosGakis and @​scana for all the contributions and help in this release 💙!

👷‍♂️ All changes

• [all] Do not set the license URL in the POMs (#​6247)
• [all] Bump Kotlin to 2.1.0 (#​6291)
• [all] Bump atomicfu (#​6245)
• [intellij-plugin] Play nice with IDEs without Kotlin/Gradle (#​6358)
• [intellij-plugin] Reduce usage of GradleExecutionHelper (#​6355)
• [intellij-plugin] Use our own executeOnPooledThread instead of Android Plugin's (#​6310)
• [intellij-plugin] Make Java and Kotlin dependencies optional (#​6304)
• [intellij-plugin] Pass arguments to rover (#​6303)
• [intellij-plugin] Move Rover settings to own section and add note about needing v0.27.0+ (#​6278)
• [intellij-plugin] Remove untilBuild (#​6279)
• [intellij-plugin] Add support for the Apollo LSP via Rover (#​6274)
• [intellij-plugin] Don't reference AdbShellCommandsUtil.executeCommandBlocking that's been removed (#​6268)
• [intellij-plugin] Make verifyPlugin fail on certain problems (#​6256)
• [intellij-plugin] Do not use internal symbol (#​6255)
• [intellij-plugin] Add explicit dependency to com.intellij.modules.json (#​6254)
• [gradle-plugin] Add a fail-safe mode to disable 2-step introspection and use minimal introspection query (#​6360)
• [gradle-plugin] Isolated Projects support (#​6351)
• [gradle-plugin] expose the outgoing variants (#​6329)
• [gradle-plugin] Better Gradle error message (#​6326)
• [gradle-plugin] Fix classloader caching. Many thanks @​scana for catching this (#​6309)
• [gradle-plugin] Manage our classloaders manually (#​6305)
• [gradle-plugin] Only call onSchema() once in multi-module scenrios (#​6252)
• [runtime] Copy executionContext inside HttpRequest.newBuilder (#​6350)
• [runtime] Apple HttpEngine: lock the handlers map (#​6348)
• [runtime] Allow to initialize WebSocketEngine lazily (#​6290)
• [runtime] Remove CloseableBackgroundDispatcher (#​6286)
• [runtime] Override JsonNumber.toString() (#​6273)
• [runtime] Implement ApolloWebSocketClosedException on darwin targets and update docs (#​6275)
• [ast] Make deprecation.reason non-nullable (#​6311)
• [ast] Allow multiple @​link schema extensions (#​6284)
• [normalized-cache] Add ApolloStore.ALL_KEYS to notify all watchers (#​6337)
• [http-cache] HTTP cache: do not remove cached entries on transport errors (#​6314)
• [execution] Add apollo-execution (#​6356)

v4.1.0

2024-11-04

Ktor 3.0.0

Version 4.1.0 updates usages of Ktor from 2.3.11 to 3.0.0:

• If you are using apollo-runtime-js or apollo-debug-server-jvm, you need to update your app to Ktor 3.0.0+ at the same time as updating to Apollo 4.1.0 (apollo-debug-server-android is unaffected).
• If you are using the deprecated apollo-mockserver or apollo-ktor-support from this repo, you need to update to the new coordinates.

All other cases are unaffected. In particular, apollo-runtime on Android and iOS uses OkHttp and NsUrlConnection respectively and is not impacted by the Ktor update.

You can read more details in the pull request.

New media type: application/graphql-response+json

application/graphql-response+json is a new media type being introduced by the GraphQL over HTTP draft. It allows differentiating a valid GraphQL response from an error JSON response that could be transmitted by a cache or proxy in the HTTP chain.

If your server uses application/graphql-response+json and returns non-2xx response, Apollo Kotlin will now parse those responses and expose data and errors instead of returning an ApolloHttpException before.

If you need to access the status code, you can do so using executionContext[HttpInfo]. For an example, you can restore the throwing behaviour with the following interceptor:

object : ApolloInterceptor {
  override fun <D : Operation.Data> intercept(
      request: ApolloRequest<D>,
      chain: ApolloInterceptorChain,
  ): Flow<ApolloResponse<D>> {
    return chain.proceed(request).onEach {
      val httpInfo = it.executionContext[HttpInfo]
      if (httpInfo != null && httpInfo.statusCode !in 200..299) {
        throw ApolloHttpException(httpInfo.statusCode, httpInfo.headers, null, "HTTP request failed")
      }
    }
  }
}

K2 support for the IntelliJ plugin

The IntelliJ plugin is now compatible with K2 (#​6150)

👷‍♂️ All changes

• [all] Update kotlinpoet to 2.0.0 (#​6215)
• [all] Update to Ktor 3 (#​6214)
• [all] Remove apollo-mockserver and apollo-ktor-support (#​6215)
• [all] Remove mockserver as a dependency of apollo-testing-support (#​6218)
• [ast] Do not escape slashes in single quoted strings (#​6190)
• [runtime] Add support for application/graphql-response+json (#​6170)
• [runtime] Do not call experimental webSocket() method re-entrently (#​6197)
• [debug server] Remove Ktor dependency from apollo-debug-server JVM (#​6224)
• [codegen] Do not add internal to private members (#​6213)
• [codegen] Fix name clash in data builder names when two types differ only by their case (#​6195)
• [gradle plugin] Allow null in KSP arguments for Apollo Compiler Plugins (#​6200)
• [gradle plugin] Do not log the full introspection JSON (#​6199)
• [gradle plugin] Deprecate TargetLanguage.KOTLIN_1_5 (#​6193)
• [IJ Plugin] Make the cache viewer understand the blob db format (#​6187)
• [IJ Plugin] Bump IJ Platform Gradle Plugin to 2.0.1 (#​6185)
• [IJ Plugin] Migrate to the K2 compatible Analysis API (#​6150)
• [IJ Plugin] Schedule the GraphQL configuration reload early (#​6228)
• [IJ Plugin] Rename related generated code when renaming an Operation/Fragment (#​6227)
• [IJ Plugin] Only highlight the name of unused operations, rather than the whole operation (#​6226)